##############################################################################
###+------------+#############################################################
#+-| CLEAR MENU |-------------------------------------------+#################
#| +------------+ The CLEAR MENU command clears the current |#################
#|                menu structure from memory                |#################
#+----------------------------------------------------------+#################
##############################################################################
##############################################################################
#+--| Syntax |--------+#######################################################
#|     CLEAR MENU     |#######################################################
#+--------------------+#######################################################
##############################################################################
##############################################################################
########+---| Description |------------------------------------------+########
########| CLEAR MENU assures that only one menu may be active at any |########
########| time.  Because the menu must allocate system memory, clear |########
########| the memu prior to using the RUN command.                   |########
########+------------------------------------------------------------+########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Make sure a menu is cleared during a help           |#########
#########| *    procedure before initializing another menu.         |#########
#########|                                                          |#########
#########| PROCEDURE help                                           |#########
#########|     VARDEF                                               |#########
#########|         INT k                                            |#########
#########|     ENDDEF                                               |#########
#########|                                                          |#########
#########|     CLEAR MENU                                           |#########
#########|     DO init_help_menu                                    |#########
#########|     MENU TO k                                            |#########
#########|                                                          |#########
#########|     DO main_menu                                         |#########
#########| ENDPRO                                                   |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Clear a menu prior to executing an external         |#########
#########| *    program or indexing a database to conserve memory.  |#########
#########|                                                          |#########
#########| IF run_extern                                            |#########
#########|     CLEAR MENU                                           |#########
#########|     DO extern_prog WITH e[ q ]                           |#########
#########|     DO setup_main_menu                                   |#########
#########| ENDIF                                                    |#########
#########+----------------------------------------------------------+#########
##############################################################################